
<html><head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<meta content="text/javascript" http-equiv="content-script-type">
<title>system.collections.IMap</title>
<link rel="stylesheet" type="text/css" href="candydoc/style.css">
<!--[if lt IE 7]><link rel="stylesheet" type="text/css" href="candydoc/ie56hack.css"><![endif]-->
<script language="JavaScript" src="candydoc/util.js" type="text/javascript"></script>
<script language="JavaScript" src="candydoc/tree.js" type="text/javascript"></script>
<script language="JavaScript" src="candydoc/explorer.js" type="text/javascript"></script>
</head><body>
<div id="tabarea"></div><div id="explorerclient"></div>
<div id="content"><script>explorer.initialize("system.collections.IMap");</script>
	<table class="content">
		<tr><td id="docbody"><h1>system.collections.IMap</h1><!-- Generated by Ddoc from F:\MyWork\phoenix\source\system\collections\IMap.d -->
该模块提供键-值映射接口。
<br><br>
<b>License:</b><br>
BSD
<br><br>
<b>Authors:</b><br>
Lucifer (786325481@QQ.com)
<br><br>


<script>explorer.outline.incSymbolLevel();</script>
<dl>
<script>explorer.outline.writeEnabled = true;</script>
<dt><span class="decl">interface 
<span class="currsymbol">IMap</span>
<script>explorer.outline.addDecl('IMap');</script>

(TKey,TValue): IEnumerable!(Pair!(TKey,TValue)), ICollection!(Pair!(TKey,TValue));
</span></dt>
<script>explorer.outline.writeEnabled = false;</script>


<dd>表示键-值对泛型集合应实现的映射接口。
<br><br>
<b>Params:</b><br>
<table><tr>
<td nowrap valign="top" style="padding-right: 8px">TKey</td>

               
<td>映射中键的类型。</td></tr>
<tr>
<td nowrap valign="top" style="padding-right: 8px">TValue</td>

               
<td>映射中值的类型。</td></tr>
</table><br>
<b>Comments:</b><br>

<span class="currsymbol">IMap</span>
<script>explorer.outline.addDecl('IMap');</script>

(TKey, TValue) 接口是键-值对泛型集合的基接口。
		每个元素都是一个存储在 Pair(TKey, TValue) 对象中的键-值对。
		每一对都必须有唯一的键。
		
<span class="currsymbol">IMap</span>
<script>explorer.outline.addDecl('IMap');</script>

(TKey, TValue) 接口允许对所包含的键和值进行枚举，但这并不意味着任何特定的排序顺序。

<br><br>
<b>Note:</b><br>
由于键可以被继承重写，因此使用 opEquals 方法进行的比较并不能保证其绝对唯一性。
<br><br>

		<b>给实现者的说明：</b>
		实现类必须有一种方式来对键进行比较。
<br><br>

 
<br><br>


<script>explorer.outline.incSymbolLevel();</script>
<dl>
<script>explorer.outline.writeEnabled = true;</script>
<dt><span class="decl">void 
<span class="currsymbol">add</span>
<script>explorer.outline.addDecl('add');</script>

(TKey <span class="funcparam">key</span>, TValue <span class="funcparam">value</span>);
</span></dt>
<script>explorer.outline.writeEnabled = false;</script>


<dd>在 IMap(TKey, TValue) 中添加一个带有所提供的键和值的元素。
<br><br>
<b>Params:</b><br>
<table><tr>
<td nowrap valign="top" style="padding-right: 8px">TKey <span class="funcparam">key</span></td>

               
<td>用作要添加的元素的键的对象。</td></tr>
<tr>
<td nowrap valign="top" style="padding-right: 8px">TValue <span class="funcparam">value</span></td>

               
<td>用作要添加的元素的值的对象。</td></tr>
</table><br>

</dd>

<script>explorer.outline.writeEnabled = true;</script>
<dt><span class="decl">bool 
<span class="currsymbol">containsKey</span>
<script>explorer.outline.addDecl('containsKey');</script>

(TKey <span class="funcparam">key</span>);
</span></dt>
<script>explorer.outline.writeEnabled = false;</script>


<dd>确定 IMap(TKey, TValue) 是否包含具有指定键的元素。
<br><br>
<b>Params:</b><br>
<table><tr>
<td nowrap valign="top" style="padding-right: 8px">TKey <span class="funcparam">key</span></td>

               
<td>要在 IMap(TKey, TValue) 中定位的键。</td></tr>
</table><br>
<b>Returns:</b><br>
如果 IMap(TKey, TValue) 包含带有该键的元素，则为 <b>true</b>；否则，为 <b>false</b>。
<br><br>
<b>Comments:</b><br>
在如何确定对象是否等同方面，这些实现可能存在差异；
		例如，ArrayList(T) 类使用 DefaultComparer(T) ，
		而 HashMap(TKey, TValue) 类允许用户指定使用 IComparer(T) 实现来比较键。
		实现在是否允许 <span class="funcparam">key</span> 为 <b>null</b> 方面有所不同。
	 
<br><br>

</dd>

<script>explorer.outline.writeEnabled = true;</script>
<dt><span class="decl">bool 
<span class="currsymbol">containsValue</span>
<script>explorer.outline.addDecl('containsValue');</script>

(TValue <span class="funcparam">value</span>);
</span></dt>
<script>explorer.outline.writeEnabled = false;</script>


<dd>测试指定的值是否存在于此 Map 中。
     
<br><br>

</dd>

<script>explorer.outline.writeEnabled = true;</script>
<dt><span class="decl">bool 
<span class="currsymbol">remove</span>
<script>explorer.outline.addDecl('remove');</script>

(TKey <span class="funcparam">key</span>);
</span></dt>
<script>explorer.outline.writeEnabled = false;</script>


<dd>根据指定的键移除 IMap(TKey, TValue) 中指定的键-值对。
	 
<br><br>

</dd>

<script>explorer.outline.writeEnabled = true;</script>
<dt><span class="decl">bool 
<span class="currsymbol">tryGetValue</span>
<script>explorer.outline.addDecl('tryGetValue');</script>

(TKey <span class="funcparam">key</span>, out TValue <span class="funcparam">value</span>);
</span></dt>
<script>explorer.outline.writeEnabled = false;</script>


<dd>获取与指定的键相关联的值。
<br><br>
<b>Params:</b><br>
<table><tr>
<td nowrap valign="top" style="padding-right: 8px">TKey <span class="funcparam">key</span></td>

               
<td>要获取其值的键。</td></tr>
<tr>
<td nowrap valign="top" style="padding-right: 8px">TValue <span class="funcparam">value</span></td>

               
<td>当此方法返回时，如果找到指定键，则返回与该键相关联的值；
				 否则，将返回 <span class="funcparam">value</span> 参数的类型的默认值。该参数未经初始化即被传递。</td></tr>
</table><br>
<b>Returns:</b><br>
如果实现 IMap(TKey, TValue) 的对象包含具有指定键的元素，则为 <b>true</b>；否则，为 <b>false</b>。
	 
<br><br>

</dd>

<script>explorer.outline.writeEnabled = true;</script>
<dt><span class="decl">ICollection!(TKey) 
<span class="currsymbol">keys</span>
<script>explorer.outline.addDecl('keys');</script>

();
</span></dt>
<script>explorer.outline.writeEnabled = false;</script>


<dd>获取包含 IMap(TKey, TValue) 的键的 ICollection(TKey)。
<br><br>
<b>Comments:</b><br>
未指定返回的 ICollection(TKey) 中的键的顺序，但可以保证它与由 values 属性返回的 ICollection(TValue) 中的相应值具有相同的顺序。
	 
<br><br>

</dd>

<script>explorer.outline.writeEnabled = true;</script>
<dt><span class="decl">ICollection!(TValue) 
<span class="currsymbol">values</span>
<script>explorer.outline.addDecl('values');</script>

();
</span></dt>
<script>explorer.outline.writeEnabled = false;</script>


<dd>获取包含 IMap(TKey, TValue) 中的值的 ICollection(TValue)。
<br><br>
<b>Comments:</b><br>
未指定返回的 ICollection(TValue) 中的值的顺序，但可以保证它与由 Keys 属性返回的 ICollection(TKey) 中的相应键具有相同的顺序。
	 
<br><br>

</dd>

<script>explorer.outline.writeEnabled = true;</script>
<dt><span class="decl">TValue 
<span class="currsymbol">opIndex</span>
<script>explorer.outline.addDecl('opIndex');</script>

(TKey <span class="funcparam">key</span>);
</span></dt>
<script>explorer.outline.writeEnabled = false;</script>


<dd>D 语言索引器重载实现。
	 
<br><br>

 获取具有指定键的元素。
	 
<br><br>

</dd>

<script>explorer.outline.writeEnabled = true;</script>
<dt><span class="decl">void 
<span class="currsymbol">opIndexAssign</span>
<script>explorer.outline.addDecl('opIndexAssign');</script>

(TValue <span class="funcparam">value</span>, TKey <span class="funcparam">key</span>);
</span></dt>
<script>explorer.outline.writeEnabled = false;</script>


<dd>设置具有指定键的元素。
	 
<br><br>

</dd>
</dl>
<script>explorer.outline.decSymbolLevel();</script>


</dd>
</dl>
<script>explorer.outline.decSymbolLevel();</script>


</td></tr>
		<tr><td id="docfooter">
			Page was generated with
			<img src="candydoc/img/candydoc.gif" style="vertical-align:middle; position:relative; top:-1px">
			on Sat Nov 29 22:33:12 2008

		</td></tr>
	</table>
</div>
<script>
	explorer.packageExplorer.addModule("platform.PAL");
	explorer.packageExplorer.addModule("platform.windows.Core");
	explorer.packageExplorer.addModule("platform.linux.Core");
	explorer.packageExplorer.addModule("system.Array");
	explorer.packageExplorer.addModule("system.BitArray");
	explorer.packageExplorer.addModule("system.Environment");
	explorer.packageExplorer.addModule("system.Event");
	explorer.packageExplorer.addModule("system.Exception");
	explorer.packageExplorer.addModule("system.Hash");
	explorer.packageExplorer.addModule("system.IntPtr");
	explorer.packageExplorer.addModule("system.Random");
	explorer.packageExplorer.addModule("system.Traits");
	explorer.packageExplorer.addModule("system.TypeTuple");
	explorer.packageExplorer.addModule("system.math.IEEE");
	explorer.packageExplorer.addModule("system.math.Math");
	explorer.packageExplorer.addModule("system.runtime.c.complex");
	explorer.packageExplorer.addModule("system.runtime.c.config");
	explorer.packageExplorer.addModule("system.runtime.c.ctype");
	explorer.packageExplorer.addModule("system.runtime.c.errno");
	explorer.packageExplorer.addModule("system.runtime.c.fenv");
	explorer.packageExplorer.addModule("system.runtime.c.inttypes");
	explorer.packageExplorer.addModule("system.runtime.c.limits");
	explorer.packageExplorer.addModule("system.runtime.c.locale");
	explorer.packageExplorer.addModule("system.runtime.c.math");
	explorer.packageExplorer.addModule("system.runtime.c.signal");
	explorer.packageExplorer.addModule("system.runtime.c.stdarg");
	explorer.packageExplorer.addModule("system.runtime.c.stddef");
	explorer.packageExplorer.addModule("system.runtime.c.stdint");
	explorer.packageExplorer.addModule("system.runtime.c.stdio");
	explorer.packageExplorer.addModule("system.runtime.c.stdlib");
	explorer.packageExplorer.addModule("system.runtime.c.string");
	explorer.packageExplorer.addModule("system.runtime.c.time");
	explorer.packageExplorer.addModule("system.runtime.c.wctype");
	explorer.packageExplorer.addModule("system.text.UTF");
	explorer.packageExplorer.addModule("system.threading.Atomic");
	explorer.packageExplorer.addModule("system.threading.ThreadUtility");
	explorer.packageExplorer.addModule("system.threading.synchronization.SpinWait");
	explorer.packageExplorer.addModule("system.collections.ArrayList");
	explorer.packageExplorer.addModule("system.collections.Comparer");
	explorer.packageExplorer.addModule("system.collections.Deque");
	explorer.packageExplorer.addModule("system.collections.EqualityComparer");
	explorer.packageExplorer.addModule("system.collections.Exception");
	explorer.packageExplorer.addModule("system.collections.HashMap");
	explorer.packageExplorer.addModule("system.collections.HashSet");
	explorer.packageExplorer.addModule("system.collections.ICollection");
	explorer.packageExplorer.addModule("system.collections.IComparer");
	explorer.packageExplorer.addModule("system.collections.IDeque");
	explorer.packageExplorer.addModule("system.collections.IEnumerable");
	explorer.packageExplorer.addModule("system.collections.IEnumerator");
	explorer.packageExplorer.addModule("system.collections.IEqualityComparer");
	explorer.packageExplorer.addModule("system.collections.IList");
	explorer.packageExplorer.addModule("system.collections.IMap");
	explorer.packageExplorer.addModule("system.collections.IQueue");
	explorer.packageExplorer.addModule("system.collections.LinkedList");
	explorer.packageExplorer.addModule("system.collections.Pair");
	explorer.packageExplorer.addModule("system.collections.PrimeHelper");
	explorer.packageExplorer.addModule("system.collections.PriorityQueue");
	explorer.packageExplorer.addModule("system.collections.Queue");
	explorer.packageExplorer.addModule("system.collections.RBTree");
	explorer.packageExplorer.addModule("system.collections.Stack");
	explorer.packageExplorer.addModule("system.collections.TreeMap");
	explorer.packageExplorer.addModule("system.collections.TreeSet");
	explorer.packageExplorer.addModule("system.collections.objectmodel.ListCollection");
	explorer.packageExplorer.addModule("system.collections.objectmodel.ReadOnlyListCollection");</script>
</body></html>


